home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / news / TrimNews.lha / TrimNews.doc < prev   
Text File  |  1995-06-26  |  3KB  |  112 lines
  1.  
  2.   Welcome to TrimNews 1.007!
  3.  
  4.  
  5.   Legal mumbo-jumbo
  6.   =================
  7.  
  8.   TrimNews is not public domain nor shareware, it`s just
  9.  
  10.     Copyright © 1995 Sönke Tesch
  11.  
  12.   Everyone is permitted to copy and distribute verbatim copies of this archive
  13.   and its contents, but changing it is not allowed.
  14.  
  15.  
  16.   What is it
  17.   ==========
  18.  
  19.   TrimNews is a replacement for the trimnews that comes with the AmigaUUCP
  20.   package. It does basically the same (you may replace the old with this one
  21.   without further changes) but is not limited to simple `timeouts` and you
  22.   have better control of what it does and where it does its work.
  23.  
  24.   So have a quick look at the rest of this file and you`ll see.
  25.  
  26.  
  27.   How to use
  28.   ==========
  29.  
  30.   TrimNews accepts the following arguments on the command line:
  31.  
  32.   NEWSDIR=NEWS/K,ACTIVEFILE=ACTIVE/K,DELOLDERTHAN=DOT/N/K,ADDDAYS/N/K,SUBDAYS/N/K,
  33.   DONTTRIM/M,DONTREMOVE/S,LOG/S
  34.  
  35.   - NEWSDIR=NEWS/K (default is uunews:)
  36.  
  37.     NEWSDIR describes the place where your articles are stored. This will normally
  38.     be uunews:.
  39.  
  40.   - ACTIVEFILE=ACTIVE/K (default is uulib:newsgroups)
  41.  
  42.     ACTIVEFILE is the file that contains a list of all newsgroups you want on
  43.     your machine.
  44.     Each line must have the following format:
  45.  
  46.       AREANAME/A,DELOLDERTHAN/N,MAXFILES/N,NEVER/S
  47.  
  48.       - AREANAME/A
  49.  
  50.         should be obvious..
  51.  
  52.       - DELOLDERTHAN/N
  53.  
  54.         TrimNews will delete all articles older than DELOLDERTHAN days.
  55.  
  56.       - MAXFILES/N
  57.  
  58.         You can limit the number of articles with this argument. If there
  59.         are more than MAXFILES files, TrimNews will start deleting the
  60.         oldest files until there are MAXFILEs left.
  61.  
  62.       - NEVER/S
  63.  
  64.         If you want to keep all articles in this area, just set NEVER or
  65.         DELOLDERTHAN=0.
  66.  
  67.       If both DELOLDERTHAN and MAXFILES are set, TrimNews will first delete
  68.       all files older than DELOLDERTHAN days and then check if there are more
  69.       than MAXFILE files left.
  70.  
  71.   - DELOLDERTHAN=DOT/N/K (default are 5 days)
  72.  
  73.     Set the default number of days until articles expire. This value is only
  74.     valid for newsgroups that are listed without any other argument.
  75.  
  76.   - ADDDAYS/N/K,SUBDAYS/N/K
  77.  
  78.     Add or subtract days from the DELOLDERTHAN of _every_ newsgroup.
  79.  
  80.   - DONTTRIM/M
  81.  
  82.     If you don`t want TrimNews to process some areas, enter them here. Use
  83.     standart AmigaDOS wildcards (#? etc) if you like.
  84.     TrimNews notifies you of every newsgroup it didn`t work on.
  85.  
  86.   - DONTREMOVE/S
  87.  
  88.     Normally TrimNews deletes all groups and their contents (except other listed
  89.     newsgroups) not listed in your ACTIVEFILE.
  90.     If DONTREMOVE is set, these groups are treated like any other group that is
  91.     in your ACTIVEFILE without arguments (thus just deletes all files older than
  92.     DELOLDERTHAN days).
  93.  
  94.   - LOG/S
  95.  
  96.     When TrimNews is working, you`ll always see the current area, but you`re only
  97.     `really` notified if TrimNews deleted some files (or the entire directory).
  98.     With LOG set, TrimNews writes a comment on every group, whether it did some-
  99.     thing or not.
  100.  
  101. In case you have any questions, suggestions or find bugs, feel free to drop me
  102. line (or two..), my address is "soenke_t@freeside.shn.com".
  103.  
  104. have fun,
  105.   soenk.e
  106.  
  107.   Changes since 1.005
  108.   ===================
  109.  
  110.   - added DONTTRIM/M argument and the /K`s after NEWSDIR and ACTIVEFILE so from
  111.     now on the keywords are needed to set NEWSDIR and ACTIVEFILE!!
  112.